home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / convrtrs / virtgif2.lzh / virtgif.doc next >
Encoding:
Text File  |  1990-01-06  |  6.3 KB  |  119 lines
  1. ****************************************************************************
  2. *             VirtGIF version 2.0 - Virtual Screen GIF Viewer              *
  3. *                Copyright (c) 1989, by Patrick J. Maloney                 *
  4. *                      Compuserve ID:  [73407,3676]                        *
  5. ****************************************************************************
  6. *       GIF and 'Graphics Interchange Format' are trademarks (tm) of       *
  7. *                Compuserve, Inc., an H&R Block Company.                   *
  8. ****************************************************************************
  9. VirtGIF 2.0 IS NOT PUBLIC DOMAIN.  You may try out VirtGIF 2.0 for a period
  10. of 14 days.  At the end of the 14 days, if you decide that VirtGIF is useful
  11. to you, I require that you send me a shareware donation of $10-15. Here is
  12. my address:
  13.                 Patrick J. Maloney
  14.                 301 Elder St.
  15.                 Schenectady, NY 12304
  16. ****************************************************************************
  17.       This archive, when distributed, must remain completely intact.
  18. ****************************************************************************
  19.  
  20. VirtGIF version 2.0 - User Notes - 12/24/89
  21. -------------------------------------------
  22.  
  23. VirtGIF is a program, runable only from the CLI, which will COMPLETELY
  24. display any GIF picture, using HAM mode for pics with > 32 colors.  Any
  25. picture that will not fit on the screen, i.e. bigger than 640 x 400 with <=
  26. 16 colors or bigger than 320 x 200 with > 16 colors will have only a portion
  27. of it displayed, with the user having the ability to scroll around and view
  28. the rest of the picture.  Upon payment of the shareware fee, I will send the
  29. user a complete version of VirtGIF which will allow him/her to save GIFs as
  30. IFF files.  Play around with different GIF files to get a feel
  31. of how it handles different colors/resolution.
  32.  
  33. Example:  640 x 480 w/256 colors will be displayed on a 320 x 200 HAM
  34.           screen with the ability to scroll around and see the entire
  35.           picture.
  36.  
  37. To run VirtGIF, type:
  38. 1>VirtGIF gif-file.GIF
  39.  
  40. Giving a non-gif, non-existent, or no file will cause an appropriate message
  41. to be displayed.
  42.  
  43. Once a file is determined to be a valid GIF file, an appropriately sized
  44. screen is opened and decode information is displayed in a window on the
  45. VirtGIF screen (or in the CLI window from which it was run if VirtGIF cannot
  46. open this window).  Number of rows left to process will be displayed until
  47. it is finished.  Select "Quit" from the project menu to abort VirtGIF.
  48. Select "Stop Current" from the project menu to stop the decode at the
  49. current line.  Once the image is decoded, the status window will disappear
  50. (if status is displayed in the CLI window, the VirtGIF screen will be moved
  51. to the front).  If scrolling is enabled, PRESS & HOLD the LEFT mouse button
  52. and move the pointer to scroll the picture in all directions.  (NOTE:  If
  53. the pointer reaches the edge of the screen, you will have to release the
  54. LEFT mouse button, move pointer to center of screen, then PRESS/HOLD/move
  55. again since if the pointer does not move, the program cannot detect relative
  56. positioning to scroll.)  Select "Quit" from the project menu to exit
  57. program.  Select "Info" from the project menu for program information.
  58. Choosing items from the "Resolution Menu", you can change your current
  59. screen resolution to view the picture on different screen sizes.
  60. Depending on your selection, you may be able to scroll the picture.
  61. Example:  you decode a 640 x 400 x 16 GIF on a 640 x 400 screen.  Initially,
  62. scrolling is disable.  If you select 320 x 200 from the resolution menu, the
  63. screen will change to that size and scrolling will be enabled.  If VirtGIF
  64. cannot open the requested screen size, it will default to 320 x 200.
  65.  
  66. VirtGIF 2.0 introduces a command line switch, "-c", which essentially
  67. halves the width of a GIF.  If a picture has > 32 colors and you choose this
  68. option, it averages pixels to attempt to get the best reputation.  This is
  69. useful for viewing 500 x 800 GIFs.  Try it with any GIF to see the results.
  70. It gives a better representation of the GIF by adjusting the aspect ratio.
  71. Usage:
  72. 1>VirtGIF -c 944.gif
  73.  
  74.  
  75. Additional notes:
  76. 1.  Due to the nature of HAM mode, HAM pictures which scroll will have
  77.     strange color changes on the leftmost part of the screen, and possibly
  78.     in whole areas of a single color.  However, for most pictures, this
  79.     should be a minor problem.  A work-around is in the works for this.
  80. 2.  This program has been tested up to a resolution of 1024 x 768 with 16
  81.     colors, but this requires that you have at least 430K of CHIP RAM free,
  82.     which is cutting it close.  Try it and see if it will work for you.
  83.     The program WILL NOT handle a GIF wider than 1024 pixels.  Use the "-c"
  84.     command line switch to halve its size and it will work.
  85. 3.  This program can be slow at times, so be patient when decoding large
  86.     pictures.  I have attempted to speed it up in this version.
  87. 4.  Runs fine with expansion memory.
  88. ----------------------------------------------------------------------------
  89. To get the version which allows saving of screens/pictures to IFF files, I
  90. am requesting a shareware fee of $10-15.  This is to help procure more
  91. development hardware/software so that I can produce more and better
  92. software.  Save SCREEN to IFF file will allow you to save the visible screen
  93. to an IFF file.  Save PICTURE to IFF file will allow you to save the entire
  94. picture to an IFF file, so if you have a 640 x 480 x 256 GIF, you can save
  95. this to an IFF file for later viewing using DigiPaint, SuperView II, etc.
  96. Paying the registration fee also entitles you to receive future versions
  97. free of charge.
  98.  
  99. Send fee to:
  100.     Patrick J. Maloney
  101.     301 Elder St.
  102.     Schenectady, NY 12304
  103. ----------------------------------------------------------------------------
  104. Additions for future versions:
  105.  
  106.    - Faster decoding.
  107.    - Save displayed portion (when scrolling) as IFF.
  108.    - Eliminate annoying color distortions on left border of screen
  109.      in HAM mode
  110.    - Allow user to force different resultion/scroll (i.e., display
  111.      640 x 400 pics with <=16 colors on 320 x 200 screen with scrolling)
  112.    - Any others you suggest...
  113.  
  114. ALL comments(positive/negative) and suggestions are welcome!
  115. My address is at the beginning of this doc file or I can be reached on
  116. CompuServe by using my account number:
  117.  
  118. -->      Patrick Maloney [73407,3676]
  119.